import { type AtomConfig, type AtomType } from "../atom/atom";
export type PaginationAtomType = AtomType<number> & {
    readonly currentPage: number;
    next(): void;
    prev(): void;
    reset(): void;
    readonly name: "paginationAtom";
};
/**
 * Creates a reactive pagination atom.
 *
 * Inherits the full `AtomType<number>` interface — callable, `.get()`,
 * `.set()`, `.update()`, `.val`, `.__subscribe()`, `.__version__`,
 * `.lock()` / `.unlock()`, `.toJSON()` — plus pagination-specific helpers:
 *
 * - `currentPage` — alias for the current value.
 * - `next()`      — increment by 1.
 * - `prev()`      — decrement by 1 (floors at 1).
 * - `reset()`     — set back to 1.
 *
 * @param initial - Starting page number (default: 1).
 *
 * @example
 * const page = paginationAtom(1);
 * page.next();        // 2
 * page.prev();        // 1
 * page.reset();       // 1
 * page();             // 1  — callable read
 * page.currentPage;   // 1
 */
export declare const paginationAtom: (initial?: number, config?: AtomConfig) => PaginationAtomType;
//# sourceMappingURL=paginationAtom.d.ts.map